home *** CD-ROM | disk | FTP | other *** search
/ Shareworld 7 / Shareworld 7 (Disk 2 of 2).adf / PolyDemo1.00 / PolyDemo1.00.docs / PolyDemo1.00.docs
Text File  |  1996-10-09  |  4KB  |  95 lines
  1.        *** PolyDemo v1.00  -  By Carl Read  -  Public Domain ***
  2.  
  3. PolyDemo is a demonstration of Blitz Basic's Poly and PolyF commands. 
  4. Along with the program itself there should be a Blitz listing in both 
  5. Blitz and ASCII/ANSI format. An explanation of the listing can be found 
  6. in the diskmag ShareWorld #7 released in October 1996.
  7.  
  8. What PolyDemo does is allow you to place polygons on the screen and 
  9. animate them. This is not a serious attempt at producing a polygon 
  10. animation program however as all you can do with it is show one polygon 
  11. per frame. You're also limited to 40 sides per polygon and 200 polygons 
  12. - or 200 frames of animation if you want to look at it that way. One 
  13. other limitation is due to Blitz's PolyF command. It can't draw complex 
  14. shapes so I suggest experimenting with PolyDemo to find out what shapes 
  15. it can and can't draw. If you're lucky there should also be some 
  16. animations (with a ".polys" extension on their file-names) with 
  17. PolyDemo.
  18.  
  19.                         *** Using PolyDemo ***
  20.  
  21. When you first run PolyDemo you're presented with a totally blank 
  22. screen. Start out by drawing some polygons on it (such as triangles) by 
  23. clicking on the screen with the mouse and then moving the pointer and 
  24. clicking again as you would in a paint program. To finish a polygon 
  25. click on the start of the first line you drew. The polygon will then 
  26. change colour. When you've a nice selection of shapes on your screen, 
  27. press the right mouse button to access the menu at the top of the 
  28. screen and select Play from it. Your polygons will then be displayed 
  29. rapidly one after another and, if you're lucky, they'll now be solid 
  30. shapes. Well, they won't be displayed too rapidly on an 68000 machine, 
  31. I making the mistake of using a hi-res screen for the program. It's 
  32. reasonably fast on an A1200 though.
  33.  
  34. Click the mouse button to stop the animation and you can then add more 
  35. polygons to the screen if you want or select another of the menu 
  36. options. Which are...
  37.  
  38.                          *** Menu Options ***
  39.  
  40. New       : Clears the screen so you can start afresh.
  41.  
  42. Open...   : Lets you load in a previously saved polygon file. Look for
  43.             files with an extension of ".polys".
  44.  
  45. Save      : Will save your polygons to disk. It'll open a file
  46.             requester if you haven't already set the save-path by using
  47.             Save As or Open.
  48.  
  49. Save As...: Opens a file requester so you can save your polygons to
  50.             disk. Although you can give your polygon files any name you
  51.             like, I've started out using a file-extension of ".polys"
  52.             and it'd make sense to stick with this.
  53.  
  54. Play      : Animates any polygons on the screen. Click the mouse button
  55.             to stop the animation.
  56.  
  57. Quit      : Exits the program.
  58.  
  59.                  *** Other features of the program ***
  60.  
  61. You can click in the top-right corner of the screen to move it to the 
  62. back so you can get to the Workbench or other screens. This feature 
  63. won't work while you're in the middle of drawing a polygon though else 
  64. you wouldn't be able to draw anything in the top-right corner.
  65.  
  66. PolyDemo's also very NTSC/PAL friendly. It'll open the appropriate 
  67. screen for whatever mode your machine's in and the polygon files will 
  68. be converted on loading to fit the screen as their artists (ho, ho) 
  69. intended. Meaning a polygon file saved by an NTSC Amiga will be, when 
  70. loaded into a PAL Amiga, expanded in the vertical so its apparent size 
  71. will look the same as on the NTSC machine. And of course the opposite 
  72. happens when files are moving the other way. This is one advantage of 
  73. vector graphics over bitmaps. (I should have thought of this in the 
  74. beginning and allowed for different screen resolutions too. Sorry about 
  75. that.)
  76.  
  77. This program and its listing are public domain so feel free to spread 
  78. it and modify it to your heart's content. Given multiple polygons per 
  79. frame and the option of different coloured polygons, (not to mention an 
  80. editing facility), could turn it into a possibly useful (if pretty 
  81. rough) polygon animation designer.
  82.  
  83. Anyone wishing to get in touch can do so at the following address...
  84.  
  85. Carl Read
  86. CyberCraft
  87. PO Box 14032
  88. Mayfair
  89. Hastings 4201
  90. NEW ZEALAND
  91.  
  92. Enjoy. Carl Read - 6th October 1996.
  93.  
  94.  
  95.